home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / cwcted10.zip / WCSYSOP.DOC < prev   
Text File  |  1992-09-12  |  8KB  |  197 lines
  1.  
  2.  
  3.  
  4.                             CWCTxtEd version 1.0
  5.  
  6.                  A Color-capable Prompt Editor for WILDCAT! 3.x
  7.  
  8.                       A Planet >< Programming Production
  9.                       Copyright (C) 1992  by Tim Kilgore
  10.                  Protected under Missouri General Copyright Law
  11.                              ALL RIGHTS RESERVED
  12.  
  13.  
  14.  
  15.  Program Description -
  16.  
  17.     CWCTxtEd is a drop-in replacement for MSI's capable MKWCTEXT.EXE.
  18.     CWCTxtEd has several advancements over MKWCTEXT; being able to view
  19.     the prompts in color as you change them, search and replace, and
  20.     drop-down file selection boxes being the most notable improvements.
  21.  
  22.     This shareware release has some limitations.  See LIMITATIONS OF
  23.     THE SHAREWARE VERSION, below.
  24.  
  25.  
  26.  Disclaimer -
  27.  
  28.     YOUR USE OR MISUSE OF CWCTXTED INDICATES YOUR AGREEMENT WITH THE
  29.     FOLLOWING TERMS.  THE AUTHOR, TIM KILGORE, WILL NOT BE HELD
  30.     RESPONSIBLE FOR ANY DAMAGES, REAL, EMOTIONAL, OR OTHERWISE.  YOU
  31.     USE CWCTXTED AT YOUR OWN RISK.
  32.  
  33.  
  34.  Why CWCTxtEd -
  35.  
  36.     A few months ago I tried to change some of the prompts to my liking.
  37.     After an hour of making a few changes, exiting MKWCTEXT, loading
  38.     WILDCAT, looking at the color change, and then returning to
  39.     MKWCTEXT, I decided that there had to be a better way.
  40.  
  41.     Enter CWCTxtEd.
  42.  
  43.  
  44.  Operational Notes and Tips -
  45.  
  46.     CWCTxtEd is very nearly functionally the same as MKWCTEXT.  This
  47.     documentation will not cover features found in MKWCTEXT, but will
  48.     explain the major differences between the two programs.
  49.  
  50.     CWCTxtEd must be executed in the same subdirectory that contains
  51.     the prompt file that is to be altered.  These files typically end
  52.     with the following extensions -
  53.  
  54.       *.DEF   Default prompt definition files      Never changed
  55.       *.DAT   True (used) definition file          Can be changed
  56.       *.ASC   ASCII import/export text file        Can be changed
  57.  
  58.     WILDCAT! 3.5x ships with the following prompt files -
  59.  
  60.          WCTEXT.DEF, WCTEXT.DAT      Prompt-set for the BBS
  61.          TCTEXT.DEF, TCTEXT.DAT      Prompt-set for TomCat
  62.  
  63.          NOTE: TCTEXT.DAT and TCTEXT.DEF shipped with different values
  64.                in either file.  At least three prompts are different
  65.                by DEFAULT.
  66.  
  67.     If you are running a multi-node system, your best course of action
  68.     is to copy the *.DAT and *.DEF files that you wish to edit to
  69.     another subdirectory and edit them there.  This will prevent file
  70.     contention from occurring and will allow you to edit the prompts in
  71.     peace.
  72.  
  73.     The most obvious advantage that CWCTxtEd has over MKWCTEXT is the
  74.     color view port.  If you change color values and press ENTER, the
  75.     new color changes will take place in the color view port.
  76.  
  77.     The FIND function (F4 on the EDIT PROMPT menu) is the second major
  78.     advancement and you'll soon find (oww!) that it is extremely useful.
  79.     It allows you to specify replacement text without requiring you to
  80.     edit the text by hand.  If also remembers your last search and
  81.     replacement strings, so you won't have to type the same information
  82.     in over and over again.
  83.  
  84.  
  85.  Editing Prompts -
  86.  
  87.     It's a dirty job, but someone has to do it.  There are several things
  88.     that you should know about prompt editing that will make your life
  89.     a lot easier.
  90.  
  91.     You can add carriage returns (CR) and linefeeds (LF) by entering the
  92.     following special codes -
  93.  
  94.        ^M   =  1 carriage return      Homes the cursor to COL 1
  95.        ^J   =  1 line feed            Puts the cursor on the next line
  96.  
  97.     CWCTxtEd ignores all other characters prefixed with a caret (^) thus
  98.     characters such as a backspace or bell are not possible with this
  99.     release.
  100.  
  101.     The tilde (~) character is probably used by WC to force a 1/2 second
  102.     delay.  Avoid using it unless you intend bore your users to death.
  103.  
  104.     High-bit ASCII (128+) characters are usable, but I recommend avoiding
  105.     the cent sign (¢) as some terminals may use this as a high-bit escape
  106.     sequence.  Try not to use any characters with an ASCII value lower than
  107.     32 since these characters could be easily misinterpreted by the
  108.     remote terminal.
  109.  
  110.     High-bit characters are easily entered.  This is an ASCII 254 - ■.
  111.     To create it, press and HOLD your ALT key.  Now enter 254 from the
  112.     KEYPAD.  Release ALT.  The ■ character should now appear.  Consult
  113.     your DOS manual for the codes to other characters.
  114.  
  115.     White characters on a green background is the default color for
  116.     CWCTxtEd.  You will notice prompts that start green and change
  117.     colors at some point in the middle of the string.  This means that
  118.     the prompt, when first displayed, uses the default color that
  119.     is currently active within WILDCAT!. (This is usually yellow on
  120.     black.)  If you wish to force a certain color, strings like this
  121.     need to be prefixed with your default color scheme.
  122.  
  123.  
  124. Making Things Easier -
  125.  
  126.     The biggest problem with MSI's prompt editing system is a lack
  127.     of a road map.  Wouldn't it be nice if a description file
  128.     accompanied each *.DAT file?  I'd love to see something like -
  129.  
  130.       PROMPT #: 12     Displayed when user's time is about to expire
  131.  
  132.     If you thing so too, ask the good people at MSI to provide a
  133.     description file (*.DES or *.MAP) with future releases.  If they
  134.     do, I'll gladly integrate it into CWCTxtEd!
  135.  
  136.  
  137.  CWCTxtEd Credits -
  138.  
  139.     CWCTxtEd was written entirely in MicroSoft's BASIC 7.1 and makes
  140.     no use of external libraries or tools save those that accompany
  141.     the Professional Development System.
  142.  
  143.     My thanks to Jack Regan for introducing me to QB(X) programming.
  144.  
  145.  
  146.  About the Author -
  147.  
  148.     After spending 4 years in the U.S. Army Infantry and learned nothing
  149.     more than self-discipline (which is actually under-rated) and how to
  150.     kill fellow human beings (which is over-rated), the author learned
  151.     programming as a hobby.  An interest in telecommications led to a
  152.     job with Datastorm Technologies, Inc., (maker of PROCOMM PLUS) where
  153.     he currently works as a Technical Support Technician.
  154.  
  155.  
  156.  Limitations of the Shareware Version -
  157.  
  158.     The Shareware version will only allow you to edit the first 150
  159.     prompts.  Since WCTEXT.DAT contains almost 700 prompts, you may
  160.     wish to consider registering CWCTxtEd.
  161.  
  162.     I've written several WildCat! FREEWARE utilities (SDIZ, WCFDFILE)
  163.     and I'm happy to provide these useful programs at no cost.
  164.     CWCTxtEd, though, represents much more time and effort and I feel
  165.     that it requires compensation.  Thus the cripple.  (And emulating
  166.     MSI's knarly menus was not much fun, either!)
  167.  
  168.  
  169.  Registering CWCTxtEd -
  170.  
  171.     The registration fee for CWCTxtEd is $15.00 ($20.00 Canadian).
  172.  
  173.     I personally despise waiting for registration keys and sysops are
  174.     extremely trustworthy people.  For that reason, I've elected to
  175.     use voice registration.  You call me, get your registration number,
  176.     and send the check afterword.  Instant gratification!
  177.  
  178.     I can be reached at 314.443.0419 VOICE from 6pm to 10pm daily.  Call
  179.     and get your registration number.
  180.  
  181.     If it's after-hours or you're bashful and don't want to talk, you
  182.     can send EMAIL requesting a registration number to the following
  183.     addresses -
  184.  
  185.                                  Planet ><
  186.                              1:289/5     FIDO
  187.                              15:600/101  ADULTNET
  188.                              314.443.0319 HST/DS
  189.  
  190.     Send your check or money order to -
  191.  
  192.                                  Tim Kilgore
  193.                          2601 S Providence, Lot #40
  194.                              Columbia, MO  65201
  195.  
  196.     Thanks!
  197.